---
sidebar_label: Introspection options
sidebar_position: 21
description: Manage introspection with the Hasura Metadata API
keywords:
  - hasura
  - docs
  - Metadata API
  - API reference
  - introspection options
  - disable introspection
---

# Metadata API Reference: GraphQL Introspection Options

## Introduction

API to set GraphQL introspection options. One of the options is to
disable introspection for the specified roles.

## set_graphql_introspection_options {#metadata-set-graphql-introspection-options}

`set_graphql_schema_introspection_options` is used to set graphql
introspection options. Calling this API will replace existing (if any)
introspection options.

This API can be used to disable graphql introspection for the specified roles.

```http
POST /v1/metadata HTTP/1.1
Content-Type: application/json
X-Hasura-Role: admin

{
    "type": "set_graphql_schema_introspection_options",
    "args": {
        "disabled_for_roles": [
            "guest",
            "public"
        ]
    }
}
```

### Args syntax {#metadata-set-graphql-schema-introspection-options-syntax}

| Key                | Required | Schema                                                       | Description                                                                                                     |
| ------------------ | -------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| disabled_for_roles | true     | Array of [RoleName](/api-reference/syntax-defs.mdx#rolename) | Roles for which GraphQL schema introspection should be disabled _(supported only in cloud/enterprise versions)_ |
